home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 52
/
Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso
/
Aminet
/
text
/
misc
/
udo.lha
/
rel6-7.txt
next >
Wrap
Text File
|
1999-01-08
|
89KB
|
2,160 lines
UDO-Historie
8. Januar 1999
von
Dirk Hagedorn
Asmecke 1
59846 Sundern
Deutschland
E-Mail: info@dirk-hagedorn.de
Aktuelle Version: Release 6 Patchlevel 12
Inhaltsverzeichnis
==================
1 Änderungen seit Release 6
1.1 PL12 vom 08.01.1999
1.2 PL11 vom 23.07.1998
1.3 PL10 vom 29.04.1998
1.4 PL9 vom 16.04.1998
1.5 PL8 vom 03.04.1997
1.6 PL7 vom 11.12.1997
1.7 PL6 vom 23.10.1997
1.8 PL5 vom 01.08.1997
1.9 PL4 vom 25.06.1997
1.10 PL3 vom 04.04.1997
1.11 PL2 vom 26.03.1997
1.12 PL1 vom 10.02.1997
1.13 PL0 vom 02.01.1997
1 Änderungen seit Release 6
****************************
1.1 PL12 vom 08.01.1999
========================
Allgemeines:
. Neu: Platzhalter (!url ...). Der Platzhalter funktioniert genauso
wie (!xlink ...), mit dem Unterschied, daß bei jedem Format ein
Link auf eine URL angelegt wird. Bisher wird der Platzhalter nur
für HTML und HTML-Help passend umgesetzt, in Zukunft wird man
auch aus WinHelp und anderen Formaten auf Internet-Inhalte
verweisen können.
. Neu: Dem Platzhalter (!raw ...) kann nun das Formatkürzel als
zusätzlicher, erster Parameter übergeben werden. Es wird er
zweite Parameter dann nur noch ausgegeben, wenn der Quelltext in
das/die im ersten Parameter angegebenen Format(e) umgewandelt
wird. Beispiel:
(!raw [html,hh] [<B>Fettschrift</b>])(!raw [rtf,win] [{\b Fettschrift}])
. Bugfix: Das Paragraphen-Zeichen in mit OS/2 erstellten Dateien
sollte nun korrekt umgesetzt werden (Ulrich Kretschmer).
!code [os2] wurde dafür intern auf !code [cp850] umgestellt.
. Bugfix: Sonderzeichen nach abgekürzten Befehlen wurden nicht
angepaßt (Markus Klik).
. Bugfix: In der unregistrierten Version gab es Probleme mit
!begin_node. So gab UDO unsinnige Fehlermeldungen aus und die
Kapitel wurden falsch numeriert (Thorsten Otto).
. Änderung: Die Kommandos !subtoc, !subsubtoc und !subsubsubtoc
bewirken nun alle dasselbe, sprich es wird jeweils das einzig
sinnvolle Unterinhaltsverzeichnis ausgegeben. Dies behbt die
Probleme, die entstanden, wenn man die Node-Struktur mit
!begin_node und !end_node aufbaute (Martin Elsässer).
AmigaGuide:
AmigaGuide wird ab dieser Version zum ersten Mal angeboten. UDO
erzeugt AmigaGuide, sofern per Kommandozeile "--amg" übergeben wird.
Das Format habe ich mit dem Programm "WinGuide", erhältlich unter
http://ftp.uni-paderborn.de/pub/aminet/misc/emu/winguide.lha,
getestet.
Leider kann AmigaGuide nicht so viel wie der ST-Guide, insofern muß
ich noch einige Dinge abspecken, wozu ich leider noch nicht gekommen
bin. Der Großteil müßte aber funktionieren.
HTML:
. Neu: Mittels !docinfo [webmastermailto] kann Einfluß auf die
Ausgabe der Mail-URL im Footer einer HTML-Seite genommen werden
(Martin Elsässer). Wird dieses "docinfo" benutzt, so hat es
Vorrang vor !docinfo [webmastermail]. Beispiel:
!docinfo [webmastermailto] dhagedorn@t-online.de?subject=UDO
. Neu: UDO erzeugt nun zusätzlich neue, deaktivierte Bilder, um
kreuz und quer durch eine Homepage zu browsen. Ist ein Link
vorhanden und sinnvoll, wird das normale Bild ausgegeben,
ansonsten ein deaktiviertes.
. Neu: Benutzt man im Vorspann den Schalter
!html_transparent_buttons, so erzeugt UDO statt der bisher
bekannten Navigationsbuttons kleinere, transparente Buttons (wie
diese aussehen, könnt Ihr auf meiner Homepage betrachten).
. Änderung: Im Inhaltsverzeichnis wird zur Erzeugung zusätzlicher
Leerzeilen nicht mehr <p> sondern <br> benutzt (Alexander
Clauss, Thomas Much).
. Änderung: Im Inhaltsverzeichnis waren die Tags <li> und <b>
vertauscht (Alexander Clauss, Thomas Much).
. Änderung: Bei Frames und Blindtabellen wird unterhalb des
"authoricon" keine Trennlinie (<hr>) ausgegeben (Wilfried Behne).
Wer weiterhin eine sehen möchte, kann seine Grafik entsprechend
anpassen.
. Änderung: Beim Einsatz von !no_images werden nun auch in den
"Top-Tocs" keine Bilder mehr benutzt, sondern die Ordnerstruktur
mit ASCII-Zeichen angedeutet.
. Änderung: Beim Einsatz von !no_images werden wie bisher keine
Browse-Buttons ausgegeben, allerdings wird nicht mehr das
Linkziel ausgegeben, sondern ASCII-Pfeile, welche zudem mit
eckigen Klammern und Pipesymbolen voneinander getrennt sind.
. Änderung: UDO sollte nun mit den Browse-Buttons in der Kopf- und
Fußzeile nun immer den richtigen Vorgänger und Nachfolger
ansteuern, auch dann, wenn man Kapitelnamen doppelt vergeben hat
(Herbert Müller).
. Änderung: Konnte UDO ein !chaptericon nicht finden, wird dies nun
im Logfile bemängelt.
. Änderung: Die benutzten Tabellen zum Layouten der Seiten, wenn
man !html_modern_layout oder !html_frames_layout benutzt, wurden
verbessert. So wird nun immer die ganze Browserfläche genutzt, so
daß bei wenig Text z.B. ein <hr> nicht nur die Hälfte der Seite
belegt (Wilfried Behne).
. Bugfix: Beim Auslesen der Ausmaße der Inline-Bilder ((!img))
wurde auch dann, wenn es kein GIF war und !no_img_size gesetzt
wurde gesucht. Außerdem wurde nicht im Outfile-Pfad gesucht.
. Bugfix: !docinfo [authoricon] beachtet nun die Einstellungen von
!html_img_suffix und verlangt nicht mehr zwingend ein GIF.
Außerdem wird kein Doppel-".gif" mehr erzeugt, wenn man die
Endung bereits angegeben hatte (Wilfried Behne). Wird ein GIF
benutzt und konnte UDO das GIF nicht öffnen, um die Ausmaße zu
ermitteln, so gibt UDO eine Fehlermeldung aus.
. Bugfix: Doppelte Anführungszeichen wurden falsch umgesetzt. Bei
dem zweiten " wurden Zeichen abgeschnitten (Hans F. Braun).
. Bugfix: Wenn kein Inhaltsverzeichnis ausgegeben wird, sprich
!tableofcontents nicht benutzt wird, so wird kein Link mehr auf
"#UDOTOC" mehr ausgegeben (Michael Depke).
. Bugfix: Beim Einsatz von !html_modern_layout wurden noch zwei
überflüssige "rowspan=2" ausgegeben.
RTF:
. Änderung: Wird !no_numbers eingesetzt, so werden vor der
Kapitelüberschrift keine Leerzeichen mehr ausgegeben.
. Änderung: Kapitelüberschriften werden nun linksbündig, also nicht
mehr im Blocksatz ausgegeben (Norbert Hanz).
ST-Guide:
. Bugfix: Ein sz in einer verbatim-Umgebung wird nun nicht mehr
durch ein Beta ersetzt (Dietmar Hollenberg).
WinHelp:
. Bugfix: !win_propfont funktionierte nicht (Norbert Hanz).
. Bugfix: !win_old_keywords funktionierte nicht für Aliase (Andreas
Swazinna).
WinHelp4:
. Bugfix: Die Bullets der itemize-Umgebung kamen im PostScript-Stil
(fehlendes break im Sourcecode).
. Bugfix: !wh4_propfont funktionierte nicht (Norbert Hanz).
. Bugfix: Die Farbbefehle !wh4_backcolor, !wh4_backcolor und
!wh4_linkcolor funktionierten nicht.
1.2 PL11 vom 23.07.1998
========================
Allgemeines:
. Neu: Befehl !comment. Den hatte ich irgendwie vergessen,
oder falls doch nicht, irgendwie den Überblick verloren.
Jedenfalls kann man mit diesem Kommando eine Zeile Kommentar
in die Ausgabedatei schreiben.
. Neu: Benutzt man im Vorspann den Schalter
!no_table_lines [<kürzel>], so erzeugt UDO in Tabellen keine
vertikalen oder horizontalen Linien (Josef Becker).
Beispielsweise würde !no_table_lines [win,ipf] keine
Tabellenlinien für WinHelp und IPF erzeugen.
. Bugfix: Kein Absturz mehr bei der Benutzung der
Kommandoabkürzungen.
. Bugfix: Die Länge eines quotierten Ausrufungszeichens wurde
nicht immer richtig berechnet, was sich besonders dann
negativ bemerkbar machte, wenn man quotierte UDO-Befehle in
Tabellen darstellen wollte (Gedächtnisstütze für mich:
toklen() geändert).
HTML:
. Änderung: Die Tabellen-Caption wird nun direkt hinter dem
<table>-Tag ausgegeben (Wilfried Behne, Alexander Clauss).
CAB erzeugte sonst eine Fehlermeldung.
. Änderung: Statt "<i>" wird im Footer nun "<address>"
verwendet (Stefan Braunstein).
. Änderung: Für die Kommandos !smallskip, !medskip und
!bigskip wird wieder nur "<br>" ausgegeben (Norbert Hanz).
PostScript:
Ab diesem Patchlevel unterstützt UDO auch PostScript. Mein großer
Dank gilt Christian "chrisker" Krüger, ohne dessen Mithilfe die
PostScript-Unterstützung noch lange hätte auf sich warten lassen.
UDO stützt sich auf ein von Christian entwickeltes Script. Die
Umsetzung steckt noch in den Kinderschuhen. Christians Script
ermöglicht noch nicht alles (keine Bilder, keine Fußnoten, ...)
und UDO kann noch nicht einmal alles das, was Christians Script
bereits abdeckt.
Daher betrachtet bitte die jetzigen PostScript-Dateien als völlig
unkomplett, teilweise fehlerhaft. Ich hätte Euch die bisherige
Funktionalität eigentlich verschwiegen, allerdings erbitten
Christian und ich uns Resonanz von denjenigen, die PostScript
benötigen oder sich damit auskennen.
Als Kommandozeilenoption fungiert "--ps".
RTF:
. Änderung: Zwischen Kapitelnummer und -bezeichnung wird nun
kein Tabulator mehr, sondern zwei Leerzeichen ausgegeben
(Norbert Hanz).
WinHelp:
. Änderung: Titelseite und UDO-Werbeseite, die Ausrichtung der
Bilder sowie die Non-Scrolling-Regions wurden an WinHelp4
(Help Workshop) angepaßt (Norbert Hanz).
. Änderung: Im Inhaltsverzeichnis steht der Titel nun auch in
einer Non-Scrolling-Region.
. Änderung: Die MAP-Datei hat nun die Endung ".hpc"
. Neu: Kommandozeilenoption "--map-pas"
UDO legt dann zusätzlich eine MAP-Datei für Pascal/Delphi
mit der Endung ".hpp" an. Bestehende Dateien werden ohne
Vorwarnung überschrieben! (Dies betrifft auch WinHelp4)
. Neu: benutzt man im Vorspann den Schalter !win_old_keywords,
so erzeugt UDO wieder wie vor einiger Zeit WinHelp-Keywords,
die aus dem eines Nodes, Alias oder Labels gebildet werden
(Andreas Swazinna).
WinHelp4:
UDO unterstützt nun ein "neues" Format: WinHelp4. Zur Umwandlung
in ein Helpfile wird der Microsoft Help Workshop 4.0x benötigt
(HCW.EXE), welcher kostenlos bei Microsoft erhältlich ist. Ich
habe die URL nicht im Kopf; wer die Datei bei Microsoft nicht
findet, sollte mal bei http://www.helpmaster.com vorbeischauen
(sowieso empfehlenswert).
WinHelp4 unterscheidet sich von WinHelp dadurch, daß UDO eine
kleinere Schrift benutzt (MS Sans Serif 8pt), dadurch die
Einrückungen in Inhaltsverzeichnissen, Aufzählungen und Tabellen
ebenfalls schrumpfen, automatisch ein Contents-File (.cnt-File)
erzeugt wird und die Projektdatei (.hpj) ein paar andere Einträge
besitzt.
Damit UDO WinHelp4-Dateien erzeugt, übergibt man per
Kommandozeile die Option "-4" bzw. "--win4". WinHelp4 wird dazu
ab der UDOSH32 1.02 unterstützt.
Für WinHelp4 gibt es analog zu WinHelp folgende neue Kommandos
und Schalter (die Funktionsweise ist identisch):
+--------------------------+--------------------------+
| WinHelp | WinHelp4 |
+--------------------------+--------------------------+
| !win_helpid | !wh4_helpid |
| !win_charwidth | !wh4_charwidth |
| !win_propfont | !wh4_propfont |
| !win_backcolor | !wh4_backcolor |
| !win_textcolor | !wh4_textcolor |
| !win_background | !wh4_background |
| !win_inline_bitmaps | !wh4_inline_bitmaps |
| !win_high_compression | !wh4_high_compression |
| !win_medium_compression | (nicht möglich) |
+--------------------------+--------------------------+
| Kürzel für Schalter: win | Kürzel für Schalter: wh4 |
+--------------------------+--------------------------+
Ich bitte um Rückmeldung, falls etwas nicht wie gewünscht
funktioniert!
Neu: Schalter !wh4_old_keywords, Funktionsweise analog zu
!win_old_keywords.
1.3 PL10 vom 29.04.1998
========================
Allgemeines:
. Bugfix: Bei sehr langen Parametern bei (!xlink) stürzte UDO
ab (Patrick Jerchel).
. Neu: Befehlssatz, um benutzerdefinierte, bereits im
Ausgabeformat vorliegende Header und Footer einzubinden
(Patrick Jerchel).
!use_raw_header <file>: Die Datei soll am Anfang der Seite
1:1 ausgegeben werden. Wird der
Befehl im Vorspann benutzt, so
wird für jede Seite die Datei am
Anfang ausgegeben. Wird der Befehl
in einem Node benutzt, so wird die
Datei nur für diesen Node
ausgegeben.
!use_raw_footer <file>: Analog für den Footer.
!ignore_raw_header: Darf nur in einem Node benutzt
werden und besagt, daß in diesem
Node die global geltende
Headerdatei nicht ausgegeben
werden soll. Somit kann man
einzelne Nodes davor schützen,
einen Header zu erhalten.
!ignore_raw_footer: Analog für Footer.
Da dies eine eilige Angelegenheit war, werden diese Header
und Footer momentan nur für HTML unterstützt. Nähere
Informationen siehe Abschnitt "HTML".
HTML:
. Neu: Benutzerdefinierte Header und Footer (Patrick Jerchel).
Möchte man die benutzerdefinierten Header und Footer
benutzen, so sollte man folgende Dinge beachten:
- UDO gibt den Inhalt der angegebenen Datei 1:1 direkt
nach dem BODY-Tag aus. Das bedeutet, daß in der Datei
die Tags "<HTML>", "<TITLE>", "<BODY>" und die
zugehörigen schließenden Tags nichts verloren haben.
- Man ist selber für die korrekte HTML-Syntax in der
Datei verantwortlich.
- Gedacht sind die Header und Footer für die Leute, die
HTML-Dateien in einem Corporate Design erstellen müssen
und das mit den normalen Bordmitteln von UDO nicht
hinbekommen.
- Sicherlich kann man durch geschickte Programmierung
benutzerdefnierter Header und Footer UDO ein neues
Layout aufzwängen. Experimentiert ruhig mal ein
bißchen.
Diese neue Möglichkeit habe ich in allergrößter Eile
eingebaut, so daß durchaus die Gefahr besteht, daß noch
nicht alles hundertprozentig funktioniert. Bei Problemen
bitte ich daher um Rückmeldung.
. Änderung: Bei den Meta-Tags "Keywords" und "Description"
wird nun "name=" anstatt "http-equiv=" benutzt (Patrick
Jerchel). Das Meta-Tag "Email" wird nun zudem mit der
"webmasteremail" ausgegeben.
. Änderung: Bei Verwendung von (!img) erzeugt UDO nun auch
eine Fehlermeldung, falls es die Ausmaße des Bildes nicht
ermitteln konnte.
. Bugfix: Bei der Verwendung von Frames wurden keine Fußzeilen
mehr ausgegeben (Stefan Braunstein, Norbert Hanz).
. Bugfix: !html_backimage gab Müll im BODY-Tag aus (Klaus
Vogler).
HTML Help:
. Änderung: In der Browseliste wird nun genau dann ein Link
auf die erste Seite erzeugt, wenn (in dieser Reihenfolge)
Titel und/oder Programmname mittels !docinfo gesetzt wurde,
!tableofcontents oder !maketitle benutzt wurde (Norbert
Hanz)
. Änderung: Bei Verwendung von (!img) erzeugt UDO nun auch
eine Fehlermeldung, falls es die Ausmaße des Bildes nicht
ermitteln konnte.
. Bugfix: Im HHP-File tauchten HTML-Umlaute auf (Norbert
Hanz).
. Bugfix: In Indizes wurden Tilden und der ganze andere Rotz
nicht angepaßt.
geschrieben, die eigentlich ins HHC-File gehörten.
PDFLaTeX:
. Neu: Die Caption für !image wird unterstützt. Frage: Wie
richtet man sie genau wie das Bild aus (linksbündig,
rechtsbündig)?
. Änderung: Links benutzen nun "fitbh" anstatt "fitbv"
(Herbert Müller).
. Änderung: UDO benutzt im Header nun
\pdfpagewidth=\paperwidth
\pdfpageheight=\paperheight
RTF:
. Änderung: In den RTF-Befehlen für die Kopfzeile wurde ein
"\par" eingefügt, so daß die Kopfzeileninhalte nun richtig
ausgerichtet werden (Norbert Hanz).
1.4 PL9 vom 16.04.1998
=======================
Allgemeines:
. Neu: Schalter !no_popup_headlines [ ] (Josef Becker)
Die Verwendung dieses Schalters im Vorspann führt dazu, nicht wie
bei !no_headlines [ ] bei keinem Node eine Titelzeile erzeugt
wird, sondern nur bei allen Popup-Nodes.
Derzeit hat der Befehl nur Auswirkungen auf WinHelp, kann also
als "!no_popup_headlines [all]" als auch als
"!no_popup_headlines [win]" eingesetzt werden.
. Neu: Schalter !image_alignment [ ]
Im Vorspann eingesetzt bestimmt es die Standard-Ausrichtung von
Bildern, die mit !image eingebunden werden. Diese Ausrichtung
wird genau dann benutzt, wenn ein Bild außerhalb einer center-,
flushleft- oder flushright-Umgebung ausgegeben werden soll. Wird
ein Bild innerhalb einer solchen Umgebung ausgegeben, wird es
genauso ausgerichtet wie der Text innerhalb der Umgebung, sprich
ein Bild wird in einer center-Umgebung zentriert ausgegeben,
unabhängig davon, was man bei !image_alignment gesetzt hat. Will
man ein Bild in einer center-Umgebung rechtsbüdnig ausgeben, so
muß man in dem Fall noch eine flushright-Umgebung um den !image-
Befehl setzen. Alles klar? ;-) Die Syntax:
!image_alignment [center]
!image_alignment [left]
!image_alignment [right]
. Neu: Schalter !table_alignment [ ]
Funktionsweise identisch zu image_alignment. Somit können nun
auch Tabellen ausgerichtet werden, jedenfalls dann, wenn das
Format das unterstützt (wie HTML, LaTeX, PDFLaTeX, ASCII, DRC,
ST-Guide)
. Neu: Zeichensatzschalter !code [cp850] und !code [cp437] für die
Codepages 850 und 437 unter DOS (letztere ist identisch mit
!code [dos]. Wer beispielsweise Probleme hat, das
Paragraphenzeichen zu konvertieren, weil UDO komische Zeichen
ausgibt, der sollte seinen Text mit !code [cp850] einleiten
(Ulrich Kretschmer). Hinweis: Die DOS-Version von UDO
(udo386.exe) erwartet standardmäßig Texte mit Codepage 437 und
gibt auch diese Texte mit dieser Codepage aus.
. Neu: Ausgabeformat "UDO" (ja, richtig gelesen). Übergibt man die
Kommandozeilenoption "-u" oder "--udo", so erzeugt UDO eine
Datei, in der es den kompletten Inhalt der Eingabedatei und aller
zugehörigen Includedateien sichert. Die neue Datei ist damit zur
Weitergabe geeignet, ohne daß der Empfänger die gleiche
Verzeichnisstruktur erstellen muß (gewünscht von Martin Rost.
Nein, es war kein Streß ;-) ).
. Neu: Kommandozeilenoption "--check"
UDO startet bei Verwendung dieser Option nach dem Pass 1 ein paar
Überprüfungen bezüglich mehrfach vergebener Dateinamen für HTML,
doppelt vergebener Nodenamen, Labels und Aliasnamen (Ulrich
Kretschmer). Zudem werden nach dem Pass 2 Labels und Aliasnamen
dahingehend überprüft, ob sie überhaupt referenziert wurden
(Ulrich Kretschmer).
. Neu: Schalter !no_img_size [ ]
Mit diesem Schalter kann man unterbinden, daß UDO die Ausmaße von
Bildern ermittelt. Wird momentan nur für HTML benutzt (siehe
unten).
. Änderung: UDO gibt seine Versionsnummer nun zusätzlich im Logfile
aus (Ulrich Kretschmer).
. Änderung: Aus "Hints" wurden im Logfile "Notes".
. Bugfix: Bei Lücken in der Node-Struktur (z.B. bei einem
!subsubnode direkt nach !node) stürzte UDO entweder ab oder
würfelte Kapitelnummern durcheinander. Nun erfolgt eine Ausgabe
ins Logfile und UDO bricht die Konvertierung ab (Ulrich
Kretschmer).
. Bugfix: Bei HTML und den ascii-basierten Formaten (ASCII, DRC,
...) gab es bei folgendem Befehl ein Problem:
blah blah (!xlink [http://www.foo.com/!~bar][])
Entweder wurde die Tilde gar nicht umgesetzt, bei der URL für
HTML umgesetzt oder ganz geschluckt. Man konnte sich drehen und
wenden, bekam aber nie das gewünschte (Stefan Braunstein).
Hinweis: Hat man eine URL mit einer Tilde und möchte man die
obige, abkürzende Schreibweise für (!xlink) verwenden, so muß man
die Tilde im ersten Parameter quoten (also ! benutzen).
HTML:
. Änderung: Tabellen werden nun mit "<div align=...>" ausgerichtet,
die einzige vernünftige Möglichkeit, die außerdem auch von allen
Browsern korrekt umgesetzt wird.
. Änderung: Tabellenbeschriftungen werden nun mit "<caption
align=bottom>" erzeugt und erscheinen daher auch unterhalb der
Tabelle wie bei allen anderen Formaten.
. Syntaxänderung: Folgende Befehle für Frames- und Tabellenlayout
wurden an die normalen HTML-Befehle angepaßt:
alt | neu
---------------------------+------------------------
!html_modern_column_width | !html_modern_width
!html_modern_column_image | !html_modern_backimage
!html_modern_column_color | !html_modern_backcolor
---------------------------+------------------------
!html_frames_column_width | !html_frames_width
!html_frames_column_image | !html_frames_backimage
!html_frames_column_color | !html_frames_backcolor
Bevor Ihr jetzt wieder zu einem großen Aufschrei ansetzt, bedenkt
bitte, daß diese Befehle erst in einer der Betaversionen
eingeführt wurden und ich immer darauf hingewiesen habe, daß sich
bis Release 7 noch etwas ändern kann. Außerdem ist durch die
Angleichung an die normalen HTML-Befehle zur Steuerung von Text-,
Hintrgrundfarben und -bildern nun Einheitlichkeit geschaffen. Die
"modern"- und "frames"-Befehle beziehen sich selbstverständlich
auch weiterhin nur auf den linken Rahmen bzw. die linke Spalte,
sprich die Funktionsweise hat sich nicht geändert.
. Neu: Befehle !html_frames_textcolor, !html_frames_linkcolor,
!html_frames_alinkcolor und !html_frames_vlinkcolor. Mit ihnen
bestimmt man die Text- und Linksfarben für den linken Rahmen.
. Neu: Befehl !html_frames_position <text>
Mit diesem Befehl kann man die Position des Rahmens bestimmen,
daß die Links auf die Nodes beinhaltet. Mögliche Positionen sind
left (wie bisher, Standard), right, top und bottom (Idee von
Konstatin Sömer).
. Neu: Befehl !html_frames_height <wert>
Hiermit bestimmt man die Höhe des Rahmens, sofern man den Rahmen
oben oder unten positioniert. Funktionsweise analog zu
!html_frames_width.
. Neu: UDO ermittelt nun für Bilder im GIF-Format die jeweiligen
Ausmaße und gibt diese dann beim IMG-Tag an (Alexander Clauss).
UDO sucht die GIFs ausgehend vom Ausgabeverzeichnis, bastelt sich
also den Dateinamen aus Laufwerk und Pfad der Ausgabedatei und
dem bei !image angebenen Dateinamen zusammen. Da die Routinen
noch experimentell sind, kann man die Ermittlung der Ausmaße mit
dem Schalter !no_img_size [html] deaktivieren.
. Änderung: Das "moderne" Layout erscheint nun genau wie bei den
Frames, d.h. Browsebuttons, Copyrighttext und Counterbild
erscheinen in der rechten Tabelle (Wilfried Behne). Das
Erscheinungsbild wird dadurch einheitlicher, Probleme diverser
Browser mit dem Umbruch des Copyrighttextes werden damit
umgangen.
. Änderung: UDO übernimmt nun den kompletten Dateinamen samt Endung
bei !html_frames_backimage (Michael Streichsbier).
. Änderung: UDO macht nun bei Verwendung von !html_modern_backimage
das, was es schon immer machen sollte, nämlich HTML-Code
erzeugen, so daß in der linken Spalte das angegebene
Hintergrundbild benutzt wird.
. Änderung: Dateinamen mit Leerzeichen können nun durch
Anführungszeichen begrenzt auch bei !html_frames_backimage,
!html_modern_backimage und !html_backimage verwendet werden
. Änderung: Anführungszeichen werden wieder durch " ersetzt.
. Bugfix: In Tabellen wird nun für jede Zelle das Fonttag bei
Verwendung von !html_propfont_name benutzt. Netscape und CAB
zeigten sonst den Inhalt der Tabelle mit dem Standardfont an
(Christian Krüger).
. Bugfix: Im Inhaltsverzeichnis wurde ein "<a>" zuviel ausgegeben.
Zudem wurden die Headlines, die für Titel und Programmname
benutzt werden, falsch zentriert (Christian Nieber).
HTML Help:
. Änderung: Ins Projectfile (Endung ".hhp") wird nun zusätzlich ein
Eintrag "Flat=Yes" gesichert, damit der HHC nur die im aktuellen
Ordner vorhandenen HTML-Dateien compiliert.
. Neu: Indizes werden komplett unterstützt. Die Indizierung wird
dem HHC überlassen, da in den HTML-Dateien sogenannte KLinks
gesichert werden.
. Neu: Ausmaße von GIFs werden ermitteln (siehe auch HTML).
LaTeX:
. Bugfix: Wenn in einer Zeile mit einem Kommando am Anfang die
Verbatimschrift eingeschaltet wurde, aber erst in einer der
folgenden Zeilen abgeschaltet wurde, dann krachte es bei der
Umwandlung nach LaTeX (um das herauszufinden, habe ich mir mit
dem Debugger zwei komplette Stunden um die Ohren gehauen).
PDFLaTeX:
. Neu: UDO erzeugt PDFLaTeX bei Verwendung der Kommandozeilenoption
"-f" bzw. "--pdflatex". Dieses Format wird zum ersten Mal
erzeugt. Vieles ist noch experimentell, so wie PDFLaTeX selber
auch. Viele Dinge funktionieren bereits, einige noch nicht.
. Neu: Schalter !pdf_medium_compression und !pdf_high_compression.
Sie führen zu entsprechenden Ausgaben, damit PDFLaTeX die PDF-
Dateien komprimiert ausgibt.
. Hinweise:
1. Getestet habe ich mit der Version 0.11 und MiKTeX 1.10
2. PDFLaTeX wandelt keine LaTeX-Umlaute in den Outlines dar. Es
erwartet normale 8-Bit-Zeichen. Das werde ich noch anpassen.
Das gleiche gilt für den PDF-Info-Block.
3. PDFLaTeX meckert regelmäßig "link ends in different nesting
level than it starts". Ich weiß momentan nicht genau, woran
das liegt. Wer ähnliche Probleme bekommt, der kann das
umgehen, indem er im Vorspann !autoref [off] und
!no_links[pdf] angibt.
4. Captions von Bildern funktionieren noch nicht.
UDO-Shell:
Aufgrund der neuen Kommandozeilenschalter gibt es eine neue Version
der UDO-Shell für Windows, nun außerdem mit englischer Oberfläche. Die
GEM-Version wurde auch entsprechend angepaßt. Norbert Hanz hat seine
UDO-Shell für GEM ebenfalls bereits daran angepaßt.
1.5 PL8 vom 03.04.1997
=======================
Allgemeines:
. Neu: Befehlsabkürzungen sind nun vewendbar (Stefan Braunstein):
Kommando | Abkürzung
--------------------+-----------
!node | !n
!subnode | !sn
!subsubnode | !ssn
!subsubsubnode | !sssn
!node* | !n*
!subnode* | !sn*
!subsubnode* | !ssn*
!subsubsubnode* | !sssn*
!pnode | !p
!psubnode | !ps
!psubsubnode | !pss
!psubsubsubnode | !psss
!pnode* | !p*
!psubnode* | !ps*
!psubsubnode* | !pss*
!psubsubsubnode* | !psss*
!begin_node | !bn
!begin_node* | !bn*
!begin_pnode | !bp
!begin_pnode* | !bp*
!end_node | !en
!item | !i
!begin_itemize | !bi
!end_itemize | !ei
!begin_enumerate | !be
!end_enumerate | !ee
!begin_description | !bd
!end_description | !ed
!begin_xlist | !bxl
!end_xlist | !exl
!begin_blist | !bbl
!end_blist | !ebl
!begin_ilist | !bil
!end_ilist | !eil
!begin_tlist | !btl
!end_tlist | !etl
!begin_quote | !bq
!end_quote | !eq
!begin_center | !bc
!end_center | !ec
!begin_flushright | !bfr
!end_flushright | !efr
!begin_flushleft | !bfl
!end_flushleft | !efl
!label | !l
!alias | !a
!index | !x
!heading | !h
!subheading | !sh
!subsubheading | !ssh
!subsubsubheading | !sssh
. Neu: Befehl !mapping <nummer> (Josef Becker). Spielt nur für
WinHelp und IPF eine Rolle (siehe unten).
HTML:
. Bugfix: Alle Umgebungen sollten nun wieder ordentlich aussehen.
UDO erzeugt nun etwas veränderten HTML-Code.
. Änderung: In den auf dem <ul>-Tag basierenden
Inhaltsverzeichnissen wird nun zu jedem <li> auch ein </li>
ausgegeben.
. Änderung: Wird bei !html_modern_column_width bzw.
!html_frames_column_width statt eines dezimalen Wertes nun ein
Prozentwert angegeben, so gibt UDO nun auch einen Prozentwert
aus. Die Angabe von dezimalen Werten ist natürlich weiterhin
möglich (Patrick Jerchel).
IPF:
. Neu: Inline-Images ((!img [ ])) sollten nun funktionieren (R.
München).
. Änderung: Für die Headings wird nun "id=" anstatt "res=" benutzt.
Als IDs werden die gleichen IDs wir für WinHelp verwendet.
. Neu: Mit !mapping <nummer> kann ein res-Wert angegeben werden.
Wird in einem Node !mapping 4711 benutzt, so erzeugt UDO den
Eintrag res=4711 im IPF-Node-Header. Wird kein !mapping benutzt,
so wird auch kein res=... ausgegeben. (Josef Becker)
. Neu: "!index" wird unterstützt.
. Bugfix: Hinter "lm margin=x" fehlte ein Punkt.
. Bugfix: "!.." wurde falsch angepaßt.
. Bugfix: Schriftarten wurden in Tabellen nicht angepaßt (R.
München)
LaTeX:
. Neu: Schalter !tex_miktex, welcher dazu führt, daß UDO an
MikTeX 1.09 angepaßte Dateien erzeugt.
. Bugfix: In komprimierten Umgebungen (Stichwort !short) vergaß
UDO, Leerzeilen auszugeben, wodurch LaTeX Absatzenden nicht
erkannte.
. Bugfix: Die Umlaute in den Indizes wurden falsch behandelt
(Michael Streichsbier).
Win:
. Änderung: !jumpid wurde umbenannt in !win_helpid (!jumpid wird
aber auch noch akzeptiert, das kann sich aber irgendwann ändern).
. Neu: Kommandozeilenoption --map
UDO erzeugt bei Übergabe dieser Option eine Datei namens foo.hpm
(Help Project Map) und bindet diese zudem im HPJ-File ein. Der
Inhalt der HPM-Datei sind C-Definitionen, die man zum direkten
Aufruf von Seiten (in denen !win_helpid benutzt wird) über das
Windows-API. Die Datei wird automatisch nun auch dann erzeugt,
wenn man !win_helpid oder !mapping im Quelltext verwendet.
. Neu: Mit !mapping <nummer> kann ein numerischer Wert angegeben
werden, den UDO dann im Map-File für einen Node verwendet. Wird
kein !mapping verwendet, so sichert UDO einen Eintrag im Map-File
mit seiner internen Nummer, aber nur dann, wenn man eine
!win_helpid gesetzt hat. Sprich: Ein Eintrag wird nur dann
erzeugt, wenn man bei einem Node !mapping oder !win_helpid oder
beides verwendet.
1.6 PL7 vom 11.12.1997
=======================
Allgemeines:
. Neu: Platzhalter (!raw [...])
Der Parameter wird ohne jegliche Umwandlung, also 1:1 ausgegeben
(Herbert Müller).
. Änderung: !raw muß nicht mehr am Anfang einer Zeile benutzt
werden, sondern kann jetzt auch eingerückt benutzt werden
(Herbert Müller).
. Änderung: Zusätzlich zur Fehlermeldung "'!endif' expected" wird
nun noch im Logfile ausgegeben, in welcher Datei in welcher Zeile
das letzte !if... benutzt wurde (Ulrich Kretschmer).
. Bugfix: Nach !begin_ignore wurde alles ignoriert, auch
!end_ignore (Andreas Bruhn).
DRC:
. Neu: Vorspann-Kommando !drc_flags <wert>. Hiermit kann man den
Wert angeben, der als letzter numerischer Wert einer
Nodedefinition gesetzt werden soll (Stefan Braunstein). Beispiel:
!drc_flags 6
HTML:
. Neu: !html_propfont_name und !html_propfont_size (Ulrich
Kretschmer). Hiermit kann der Standardfont und/oder die
Standardgröße bestimmt werden. Die Größe wird gemäß HTML 3.2
angegeben. Beispiel:
!html_propfont_name Arial
!html_propfont_size -1
. Neu: Passend zum obigen Befehlssatz kann man zur Bestimmung des
nichtproportionalen Zeichensatzes für verbatim-Umgebungen die
Befehle !html_monofont_name und !html_monofont_size benutzen.
. Neu: !chaptericon_text
Hiermit kann man einen Text unterhalb eines Chaptericons
darstellen (zahlreich gewünscht).
. Neu: Mit !html_frams_column_image kann man eine Hintergrundgrafik
für den linken Frame setzen (Wilfried Behne).
. Änderung: Auf der ersten Seite wird nur noch dann ein Home-Symbol
erzeugt, wenn !html_backpage benutzt wird, welches dann auf diese
Seite zeigt (Herbert Müller).
. Änderung: !html_backpage verkraftet nun URLs mit bis zu 512
Zeichen.
. Bugfix: Wurde im ersten Node !chaptericon_active ohne
!chaptericon benutzt, so erzeugte UDO statt eines HTML-Tags nur
Müll (Norbert Hanz). Hinweis: Ein aktives Icon ohne Haupticon ist
natürlich auch nicht der Sinn der Sache. ;-)
. Bugfix: Die quotierte Tilde (! ) wurde in !docinfo [webmasterurl]
nicht korrekt umgesetzt (Michael Streichsbier).
. Bugfix: Wurden die HTML-Farbwerte geklammert (z.B.
!html_backcolor [#FFFFFF], so gab UDO eine Fehlermeldung aus,
anstatt die Farbe zu übernehmen (Herbert Müller).
IPF:
. Änderung: viele, viele, viele Änderungen hat es gegeben. So wird
jetzt fast der komplette UDO-Befehlssatz unterstützt. Einige
Kleinigkeiten (z.B. Indizes) funktionieren noch nicht.
RTF:
. Neu: --- wird in \emdash, -- in \endash umgewandelt (Norbert
Hanz).
. Bugfix: Wurden typographische Anführungszeichen in !table_caption
verwendet, so erschien die Überschrift verstümmelt (fehlende
Leerzeichen nach den RTF-Tags) (Norbert Hanz).
1.7 PL6 vom 23.10.1997
=======================
Allgemeines:
. Neu: Schalter !no_links [...]
Wird dieser Schalter im Vorspann benutzt, so werden Links nicht
umgewandelt und nur der erste Parameter des Link-Kommandos
ausgegeben. Praktisch, wenn einem z.B. in RTF das Wörtchen "siehe
..." auf die Nerven geht (Norbert Hanz).
. Neu: Platzhalter (!index [<text>]
Funktioniert genau wie (!idx [<text>], mit dem kleinen aber
feinen Unterschied, daß <text> nicht ausgegeben wird, sprich es
erfolgt nur ein Eintrag in den Index (Christian Nieber).
. Neu: Schalter !subtoc_offset, !subsubtoc_offset und
!subsubsubtoc_offset
Hiermit lassen sich analog zu !toc_offset die Offsets für die
Numerierung der Unterkapitel bestimmen (Norbert Hanz). Will man
beispielsweise die Nummern alle bei 0 starten lassen, so benutzt
man
!toc_offset -1
!subtoc_offset -1
!subsubtoc_offset -1
!subsubsubtoc_offset -1
Ihr seht, der angegebene Wert wird auf 1 addiert und als
Startnummr verwendet.
. Neu: ignore-Umgebung mit !begin_ignore und !end_ignore
Alles, was innerhalb dieser Umgebung steht, wird von UDO schlicht
und ergreifend ignoriert (zahlreich gewünscht). Ungetestet!
. Bugfix: Kein Absturz mehr bei Verwendung von
!docinfo [programimage].
. Bugfix: Versucht man eine Tabelle innerhalb einer anderen
anzulegen, beschwert sich UDO nun (Andreas Swazinna).
. Bugfix: Schachtelt man mit !begin_node zu tief, so erzeugt UDO
nun eine Fehlermeldung anstatt abzustürzen.
ASCII:
. Änderung: Werden Fett-, Kursivschrift etc. über das Zeilenende
hinaus benutzt, so schließt UDO die Effekte am Zeilenende und
öffnet sie am Anfang der nächsten Zeile erneut (Norbert Hanz).
DRC:
. Änderung: Werden Fett-, Kursivschrift etc. über das Zeilenende
hinaus benutzt, so schließt UDO die Effekte am Zeilenende und
öffnet sie am Anfang der nächsten Zeile erneut (Stefan
Braunstein).
HTML:
. Änderung: UDO benutzt nun bei Listenumgebungen "<td nowrap ...>",
um einen Umbruch in der linken Spalte zu unterbinden (Norbert
Hanz).
. Neu: Befehl !chaptericon_active
Hier kann man für den linken Rahmen bzw. für die linke Spalte ein
Bild angeben, daß nur dann angezeigt wird, wenn das Kapitel oder
eines dessen Unterkapitel angezeigt wird (Wilfried Behne).
. Neu: Schalter !html_button_alignment [left|center|right]
Sorgt für die Ausrichtung der Buttons beim "modernen" Layout
(Wilfried Behne). Default: center
. Neu: !docinfo [authoricon]
Statt !docinfo [authorimage] verwendet UDO nun für HTML nur noch
das "authoricon" für den linken Frame bzw. die linke Spalte.
Somit kann man unterschiedliche Bilder für Titelseite und Frame
verwenden.
. Neu: !html_frames_layout können folgende Parameter übergeben
werden (Norbert Hanz):
- "noresize": Fügt dem Frameset-Tag "noresize" hinzu. Die
Breite des linken Frames läßt sich dann vom Benutzer nicht
mehr verändern.
- "noborder": Fügt dem Frameset-Tag "border=0 frameborder=0
framespacing=0" hinzu. Der linke Frame hat dann keinen Rand
mehr.
- "noscrolling": Fügt dem Frame-Tag "scrolling=no" hinzu. Im
linken Frame kann dann nicht mehr gescrollt werden.
Beispiele:
- !html_frames_layout noborder noresize noscrolling
- !html_frames_layout [noborder, noresize]
. Änderung: Das "authoricon" wird nun auch bei Frames mit der
Startseite verlinkt.
. Änderung: UDO benutzt nun für Frames und das "moderne" Layout
standardmäßig keine Hintergrundfarbe mehr.
. Änderung: Ein Klick auf den aufwärts gerichteten Pfeil verzweigt
nun zum Anfang des Inhaltsverzeichnisses und nicht wie bisher zum
Anfang der Startseite (Norbert Hanz).
. Änderung: Zur Erzeugung zusätzlicher Leerzeilen (!smallskip etc.)
gibt UDO nun "<br> " aus. Der MSIE soll sonst Probleme
machen (Norbert Hanz).
. Bugfix: !html_img_suffix wird nun auch für Chaptericons beachtet
(Federico Hernandez-Püschel).
. Bugfix: Referenzen sollten nun immer stimmen, ob man nun Frames
oder das moderne Layout benutzt, gekoppelt mit dem Zusammenfassen
von Nodes oder nicht, ob man !html_name verwendet oder nicht.
Vorher gab es ein ziemliches Durcheinander.
. Bugfix: UDO stürzt nicht mehr ab, falls eine HTML-Datei nicht
erzeugt werden konnte, sondern gibt jetzt eine sinnvolle
Fehlermeldung aus.
. Bugfix: Nach einer short-Umgebung wurde ein "</p>" zuviel
ausgegeben (Norbert Hanz).
. Bugfix: Vor Absätzen, die einer Liste folgten, fehlte "<p>".
. Bugfix: Es wird nun korrekt "<li><p>" anstatt "<p><li>"
ausgegeben.
. Bugfix: Benutze man bei einer center-, flushleft- oder
flushright- Umgebung !short, so produzierte UDO nicht das, was
man bezweckte. Da die Anpassung wirklich unheimlich kompliziert
wäre, ist bis auf weiteres die Verwendung von komprimierten
Umgebungen dieser Art nicht möglich.
IPF:
. Neu: Bilder über !image sollten nun dargestellt werden. (Hauke
Wessels). Bitte testen!
RTF:
. Neu: (Endlich) Unterstützung für Bilder im BMP-Format (Befehl
!image)! Die ersten Tests erliefen erfolgreich, jedoch kann es
sein, daß UDO manche Bilder nicht findet oder Schrott erzeugt (in
diesem Falle !no_images [rtf] verwenden. Vielen Dank übrigens an
Christian Nieber für den C-Code-Schnippsel, auch wenn ich den
nicht gebraucht habe (der RTF-Export von Papyrus war wesentlich
aufschlußreicher) ;-)
. Neu: !use_nodes_inside_index [rtf], !use_label_inside_index [rtf]
und !use_alias_inside_index [rtf] werden unterstützt (Andreas
Swazinna).
. Neu: Neuer Schalter !rtf_keep_tables [on|off]
Wird !rtf_keep_tables [on] benutzt, so gibt UDO alle folgenden
Tabellen so aus, daß z.B. WinWord Tabellen am Seitenende nicht
umbricht, sondern den Seitenumbruch vor der Tabelle erzeugt. Mit
[off] schaltet man diesen Effekt für alle folgenden Tabellen
wieder aus. Default ist [off]. (Norbert Hanz)
. Änderung: UDO benutzt im RTF-Header nun \fntbj anstatt \fnttj
(Norbert Hanz).
. Änderung: Doppel- und Dreifach-Indizes werden nun korrekt
exportiert (Norbert Hanz). Hinweis: Papyrus kennt nur
"Oberbegriff" und "Unterbegriff", daher sollte man hier maximal
Doppel-Indizes verwenden.
. Änderung: Bei Verweisen verwendet UDO nun die "richtigen"
Anführungszeichen (Norbert Hanz).
. Bugfix: !no_headlines wurde nicht beachtet (Norbert Hanz).
. Bugfix: Headings beachteten Ausrichtung (center, flushright)
nicht (Norbert Hanz).
ST-Guide:
. Bugfix: Auf der UDO-Werbeseite (!udolink) wurde ein falsches
@limage benutzt (Christian Goßlar).
WinHelp:
. Änderung: Die Ausmaße des Hauptfensters wurden leicht verändert.
. Bugfix: Headings beachteten Ausrichtung (center, flushright)
nicht (Norbert Hanz).
. Bugfix: (!idx ...) innerhalb von !table_caption wurde nicht
umgewandelt (Norbert Hanz).
. Bugfix: Farben "silver" und "gray" waren vertauscht.
. Bugfix: Die Win32-Version erzeugt im HPJ-File nun DOS-Umlaute,
damit die Titelzeile des WinHelp-Fensters wieder stimmt.
GEM-Version:
. Änderung: Dateinamen, die Leerzeichen enthalten, werden nun beim
Start externer Programme mit Anführungszeichen geklammert.
Everest versteht was man will, HCP.TTP und er ST-Guide können
damit allerdings genausowenig anfangen...
. Änderung: Drag&Drop an Ease und Magxdesk angepaßt. Vorher gab es
Probleme, wenn Dateinamen Leerzeichen enthielten und mit
Apostrophen oder Anführungszeichen geklammert an UDO übergeben
wurden.
Win32-Shell:
. Änderung: Die Zieldatei kann nun korrekt bestimmt werden
(Wilfried Behne). Nach dem Ändern des Zielformates muß die
Zieldatei jedoch neu bestimmt werden, da die UDO-Shell die
Zieldatei wieder anpaßt.
. Bugfix: Anführungszeichen um den Dateinamen, der der UDOSH
übergeben wird, werden entfernt.
. Bugfix: Dateinamen mit Leerzeichen werden mit Anführungszeichen
geklammmert.
1.8 PL5 vom 01.08.1997
=======================
Allgemeines:
. Neuer Befehl: !input
Funktioniert genau wie !include jedoch sucht !input lediglich in
dem Verzeichnis, welches durch die Umgebungsvariable
$UDOINPUTPATH definiert ist.
. Neue Umgebung: !begin_node ... !end_node (Martin Osieka).
Hiermit lassen sich Nodes wie mit !node, !subnode etc. anlegen.
Welche Gliederungsebene jedoch verwendet wird, das hängt vom
übergeordneten Node ab. Nodes können hiermit also genauso
geschachtelt werden wie alle anderen Umgebungen geschachtelt
werden. Ein Beispiel:
!begin_document
!tableofcontents
!begin_node Ein Node
...
!begin_node Ein Subnode
...
!end_node
!end_node
!end_document
Die neuen Befehle lassen sich auch zusammen mit den "alten"
Befehlen verwenden, wobei zu beachten ist, daß nach einem !node
durch !begin_node ein Subnode geöffnet wird.
Durch die neuen Befehle ergeben sich interessante Möglichkeiten.
Will ich bspw. die auf meiner Homepage als Subsubnode
erscheinenden Softwarebeschreibungen in einem ST-Guide-Hypertext
oder einer Windows-Hilfe als Subnodes darstellen, so kann ich
diese nun ohne Änderung mittels !include einbinden.
. Neue Kommandos: !begin_node*, !begin_pnode, !begin_pnode*
Diese werden analog zu !begin_node, !node*, !pnode und !pnode*
verwendet. Geschlossen werden die Befehle ebenfalls mit
!end_node.
. Neu: linedraw-Umgebung, !ldinclude, !linedrawsize
Bei Nicht-RTF-Formaten wird auf den DOS-Zeichensatz umgeschaltet
und die Umgebung wie eine verbatim-Umgebung behandelt. Näheres
zur Umgebung weiter unten. !ldinclude und !linedrawsize sind
analog zu !vinclude und !verbatimsize implementiert.
. Neues Kommando: !error <text>
Genau wie die Präprozessoranweisung #error eines C-Compilers kann
man hiermit eine Fehlermeldung erzeugen und <text> ausgeben. UDO
bricht beim Eintreffen dieses Schalter die Konvertierung ab.
. Neuer Schalter: !use_auto_toptocs [<format>]
Wird dieser Schalter eingesetzt, so werden zu Beginn jedes
Kapitels Links auf die übergeordneten Kapitel erzeugt. Der
Schalter ist verfügbar für HTML, WinHelp und ST-Guide. Wird der
Schalter benutzt, so sichert UDO ein paar zusätzliche Grafiken,
die dann verwendet werden.
. Neu: !udolink
UDO sichert für HTML, WinHelp und ST-Guide eine Datei namens
"udo_wm.[gif,bmp,img]". Mit !udolink kann man in sein Werk die
Grafik einbinden. Bei HTML wird zugleich ein Link auf meine
Homepage erzeugt.
. Neu: (!comment [...]), !use_comments [...]
Mit (!comment [...]) können Inline-Kommentare für HTML, WinHelp,
RTF, Quickview, C und Pascal erzeugt werden. Wir im Vorspann der
Schalter !use_comments benutzt, so werden die Kommentare auch bei
allen anderen Formaten in Klammern ausgegeben (Martin Rost).
. Wieder da: Schalter !use_short_tocs [...]
Wer nicht die automatisch erzeugten Inhaltsverzeichnisse
benutzte, mußte viele !depth 1 einfügen. Dies ist nun nicht mehr
nötig (Andreas Swazinna).
. Änderung: Die Farbnamen wurden neu festgelegt und orientieren
sich nun an den durch HTML 3.2 definierten 16 Farben. Diese
lauten:
black
silver (hellgrau, ehemals "grey")
gray (dunkelgrau, "gray", nicht "grey"!!!)
white
maroon
red
purple
fuchsia
green (dunkelgrün)
lime (hellgrün)
olive
yellow
navy
blue
teal
aqua (ehemals "cyan")
Diese Änderung betrifft die Farbkommandos von HTML und WinHelp.
. Bugfix: UDO findet wieder sicher seine INI-Datei.
. Änderung: Mit !image kann man nun auch problemlos Bilder anzeigen
lassen, deren Dateiname Leerzeichen enthält, wenn man den
Dateinamen in Anführungsstriche setzt.
Beispiel: !image "foo bar"
. Änderung: Die Anzahl der maximal zu verwendenden Symbole wurde
von 32 auf 128 erhöht (Uwe Mindrup).
DRC:
. Neu: Schalter !drc_bcolor, !drc_icolor, !drc_ucolor
Da DRC keine verschiedenen Schriftarten kennt, sondern Text
lediglich farbig hervorheben kann, kann man mit diesen Befehlen
UDO mitteilen, in welcher Farbe fetter, kuriver und
unterstrichener Text dargestellt werden soll. Die
Farbbezeichnungen stehen oben (Stefan Braunstein).
. Bugfix: Bei !end_document wird nun immer eine Zeile mit dem
Inhalt "%%" ausgegeben (Stefan Braunstein).
. Bugfix: Der Inhalt des Titelseite wird nun ordentlich
dargestellt, da UDO die Zeilen mit Leerzeichen auffüllt.
HTML:
. Neu: !docinfo [htmltitle] <text>
<text> wird für den Titel jeder Seite benutzt (anstelle der
Zusammenfassung von [title] und [program]). Beispiel:
!docinfo [title] Around the operating system
!docinfo [program] ATOS Ausgabe 02/1997
!docinfo [htmltitle] ATOS 02/97
Benutzt man [htmltitle], so sieht man im Fenstertitel eines
Browsers "ATOS 02/97: foo bar". Ansonsten stünde dort "Around the
operating system ATOS Ausgabe 02/1997: foo bar".
. Neues Kommando: !html_description
Hiermit kann man die Beschreibung einer Seite in die
Metainformationen aufnehmen (< META NAME="Description"
CONTENT="..."). Dieses Kommando ist mehrfach in einem Node
verwendbar (Frank Röske).
. Neu: !use_auto_toptocs [html] wird unterstützt.
. Änderung: Wird !html_keywors mehrfach in einem Node benutzt, so
werden die einzelnen Einträge, mit einem Komma getrennt, in die
Metainformationen aufgenommen (Frank Röske).
. Änderung: HTML 3.2 sieht kein """-Entity mehr vor, daher
verwendet UDO nun """.
. Änderung: UDO nutzt nun die Möglichkeiten von HTML 3.2, indem es
für die enumerate-Umgebung genauso numeriert wie in LaTeX,
WinHelp oder ASCII, sprich UDO benutzt "<ol type=a>",
"<ol type=i>" und "<ol type=A>" in verschachtelten Umgebungen.
. Änderung: Werden !heading, !subheading etc. in einer center- oder
flushright-Umgebung benutzt, so werden die Überschriften passend
eingerückt.
. Änderung: Aus "Letzte Änderung am" wurde "Letzte Aktualisierung
am".
. Änderung: Wenn Frames benutzt werden, so wir bei Verweisen in den
Kopfzeilen auf die Startseite nicht mehr "target="_top"" benutzt,
sondern es wird nur im rechten Rahmen die Datei mit der
Startseite neu dargestellt.
. Änderung: Nach Absätzen gibt UDO eine zusätzliche Leerzeile aus
(Martin Rost).
. Änderung: Wenn !html_merge_nodes verwendet wird, werden manche
GIFs nicht gesichert, da sie dann nicht benötigt werden.
. Bugfix: !html_keywords funktionierte auf der Hauptseite nicht
(Frank Röske).
. Bugfix: "" wurden durch " ersetzt statt durch ".
HTML-Help:
Seit Release 6 Patchlevel 5 unterstützt UDO nun den offiziellen
Nachfolger von WinHelp: Microsoft HTML Help. Den HTML-Help-Workshop
kann man sich von Microsofts Web-Site herunterladen. Die URL habe ich
gerade leider nicht im Kopf, sorry.
UDO legt die für den Workshop erforderliche Projekt-, Contents- und
Index-Datei automatisch an. Der Index bleibt momentan noch leer, das
habe ich in den fünf Stunden, die die Anpassung erfordert hat, nicht
hinbekommen.
. Neben den Standardkommandos existieren folgende Spezialbefehle:
- !hh_backimage
- !hh_backcolor
- !hh_textcolor
- !hh_linkcolor
- !hh_alinkcolor
- !hh_vlinkcolor
- !hh_img_suffix
Alle Befehle funktionieren analog zu den gleichnamigen Befehlen
für HTML.
. Ein paar Hinweise:
1. Zur Programmierung habe ich die Beta 3 des Workshops
herangezogen. Ich werde in den nächsten Tagen einmal
schauen, ob bereits eine neue Betaversion des Workshops
vorhanden ist und ob UDO angepaßt werden muß.
2. Die Beta 3 scheint keine Bilder zu finden, die nicht im
gleichen Verzeichnis wie die HTML-Dateien liegen. Jedenfalls
werden die Bilder, die ich relativ für meine Homepage
adressiere, nicht dargestellt.
RTF:
. Neu: Im RTF-Header wird nun auch eine Colortable ausgegeben. Das
bedeutet, daß man nun auch in RTF Farben verwenden kann.
. Neu: Trennvorschläge mittels "!-" (z.B. "Ur!-instinkt") werden
für RTF übernommen (Stefan Braunstein).
. Neu: Mittels der linedraw-Umgebung ist es nun möglich, in einem
RTF-File "DOS-Screenshots" oder sonstige Texte, die die DOS-
Grafikzeichen verwenden, zu erstellen. Dazu muß der Zeichensatz
"MS LineDraw" installiert sein. Word für Windows zeigt die
Passagen korrekt an, WordPad95 hingegen nicht (warum auch immer).
Analog zu !vinclude funktioniert !ldinclude: Es wird eine
komplette Datei eingelesen und in einer linedraw-Umgebung
dargestellt. Ebenfalls analog zu !verbatimsize funktioniert
!linedrawsize, womit die Zeichensatzgröße bestimmt werden kann
(Andreas Swazinna).
ST-Guide:
. Neu: !use_auto_toptocs [stg] wird unterstützt.
. Bugfix: UDO gab immer @width 0 aus (Christian Gosslar).
. Bugfix: UDO gab für !hline immer @line 0 aus (Uwe Mindrup)
. Bugfix: Statt @default "Inhaltsverzeichnis" wird nun korrekt
@default Main ausgegeben, wenn man auf eine Titelseite
verzichtet.
WinHelp:
. Neu: !win_textcolor <farbe>
Hiermit läßt sich die Farbe festlegen, mit der der Text
erscheinen soll.
. Neu: !use_auto_toptocs [win] wird unterstützt.
. Änderung: !win_backcolor ersetzt den Schalter !win_background. In
der Übergangsphase bleibt der alte Schalter noch erhalten. Grund
der Umbenennung: Angleichung an den Befehl !html_backcolor.
. Änderung: Die Palette der zu verwendenden Farben wurde an die der
HTML-3.2-Spezifikation angepaßt.
. Änderung: Der "Beenden"-Button wird nicht mehr benutzt.
Stattdessen wird bei Verwendung von !use_about_udo ein UDO6-
Button eingebaut.
. Bugfix: Die Nodes wurden bei "!depth 1" im Inhaltsverzeichnis
fett dargestellt und nicht dann, wenn die Tiefe höher war
(Andreas Swazinna).
. Bugfix: Wurde !table_caption für eine Tabelle benutzt, die
innerhalb einer anderen Umgebung stand, so erzeugte UDO
ziemlichen Murx, so daß im günstigsten Falle die
Tabellenüberschrift unsichtbar war (Norbert Hanz).
1.9 PL4 vom 25.06.1997
=======================
Ich hoffe, ich habe alle Änderungen notiert. ;-)
Zum ersten Mal gibt es eine Version für Win32 (Windows 95 und NT)
nebst neuer, besserer Shell. Beide Programme mit Debug-Informationen
ausgeliefert, deshalb benötigt man folgende DLLs:
1. MFC40D.DLL
2. MSVCRT40.DLL
3. MSVCR40D.DLL
Allgemeines:
. Änderung: Es heißt nun !docinfo [drcstatusline] anstatt
!docinfo [drc_statusline].
. Änderung: Es heißt nun !docinfo [stgdatabase] anstatt
!docinfo [stg_database].
HTML:
. Änderung: Neue, flachere Images im Win95-Look, die zudem die
Win216-Palette verwenden.
. Änderung: Bei !html_modern_layout wird nun im Header HTML 3.2
ausgegeben (Alexander Clauss).
. Änderung: Alle Bilder werden nun mit "border=0" ausgegeben.
Ausnahme: Image-Links im Text.
. Neu: UDO kann Frames erzeugen. Das Layout entspricht dem durch
!html_modern_layout erzeugten Tabellenlayout, allerdings wird das
"kleine" Inhaltsverzeichnis in einem Frame erzeugt. Wie beim
"modernen" Layout werden auch hier die sogenannten Chaptericons
beachtet.
- !html_frames_layout: Wird dieses Kommando im Vorspann
benutzt, so werden Frames erzeugt.
- !html_frames_column_width <wert>: Gibt die Breite des linken
Frames an.
- !html_frames_column_color <farbe>: Gibt die Hintergrundfarbe
des linken Frames an.
UDO benutzt folgende Dateinamen, die man selber nicht benutzen
sollte: 00con.htm[l] und 00toc.htm[l].
Externe Links werden immer mit target="_top" erzeugt. Dies wird
man auch in Zukunft nicht ändern können.
. Neu: In den Kopf-/Fußzeilen wird nun auch jeweils ein Bild
ausgegeben, das auf die Hauptseite verweist.
. Neu: Kommando !html_counter_command .... Es kann in jedem Node
benutzt werden. Was dem Kommando folgt, wird 1:1 im Footer
ausgegegen, so daß man den Counter optisch besser plazieren kann
als früher. Beim "modernen Layout" wird der Counter dann also in
der linken Spalte dargestellt.
. Bugfix: Bei den sogenannten Chaptericons wurden Backslashes nicht
in Slashes umgewandelt(Uwe Mindrup, Thomas Much).
ST-Guide:
. In den Kopfzeilen stehen nun immer mindestens zwei Leerzeichen
zwischen Kapitelnamen und Hypertexttitel (Martin Osieka).
GEM-Version:
. Der Fileselector wird nun immer mit einem großen
Laufwerksbuchstaben aufgerufen (Christian Huch).
Win32-Shell:
. Die Shell dürfte selbsterklärend sein, bis auf folgende
Kleinigkeiten:
- Die INI-Datei wird nun aus dem Verzeichnis geladen, in der
das Executable liegt. Beim Start gibt die Debug-Version
dieses Verzeichis aus.
- Unter Konfiguration können nun die Dateiendungen für die
Formate angegeben werden. Läßt man das Eingabefeld leer, so
werden Defaultendungen benutzt. Will man beispielsweise
HTML-Dateien mit der Endung .htm erzeugen (UDO32 erzeugt
defaultmäßig .html), so muß man hier in das Eingabefeld .htm
eingeben (inklusive Punkt!).
Eine Online-Hilfe werde ich nachreichen, sobald ich mehr Zeit
dazu habe, sie überhaupt zu schreiben.
1.10 PL3 vom 04.04.1997
========================
Allgemeines:
. Bugfix: Die Benutzung von !programimage und !authorimage führte
zum Absturz (Stefan Braunstein).
. Bugfix: Die korrekte Benutzung der Befehle zur Schriftumschaltung
wird nun auch bei Überschriften (Nodes und Headings) überprüft
(Jürgen Conradi), darüber hinaus nun auch bei Bildunterschriften.
Apple QuickView:
. Bugfix: Schriftarten wurden in Bidunterschriften nich
umgewandelt.
DRC:
Alle Änderungen wurden auf Wunsch von Stefan Braunstein eingebaut.
Sonst benutzt wohl niemand den DRC. ;-)
. Bugfix: Bei Subsubnodes wurden falsche Nummern benutzt. Zudem
fehlt die Angabe von "0, 0, 0,", so daß es Probleme mit
Kapitelüberschriften gab, die mit Umlauten oder Ziffern begannen.
. Bugfix: Die Status-Line wurde falsch ausgegeben.
. Änderung: !hline wird unterstützt.
. Änderung: Am Anfang von Nodes wird erst eine Leerzeile
ausgegeben, damit der Text nicht gleich unter der Fensterkante
klebt.
. Neu: Mittels !docinfo [drc_statusline] kann man den Text setzen,
den UDO für die Statuszeile verwendet. Fehlt diese Angabe, so
erzeugt UDO eine Zeile der Art "Copyright (c) by <author>". Wurde
!docinfo [author] nicht angegeben, so erzeugt UDO eine Zeile
"Made with UDO".
HTML:
. Neu: !html_modern_column_width <wert>. <wert> gibt an, wie breit
die linke Spalte der Tabelle sein soll.
. Neu: !html_modern_column_color <farbe>. <farbe> darf Werte wie
bei !html_backcolor annehmen und bestimmt die Hintergrundfarbe
der linken Spalte.
. Änderungen: Am "Modern Layout" wurde gefeilt. Die Ergebnisse
sollten nun mit Internet Explorer, Navigator und Communicator
ordentlich aussehen.
IPF:
. Bugfix: (!nl) wurde falsch umgesetzt.
. Bugfix: Die meisten Befehle, die Umgebungen beenden, wurden nicht
umgesetzt.
. Bugfix: docprof wurde falsche ausgegeben.
LyX:
. Bugfix: In Bildunterschriften wurden interne Zeichen von UDO
nicht angepaßt.
ST-Guide:
. Neu: Mittels !docinfo [stg_database] kann man angeben, was UDO
für die @database-Zeile ausgeben soll. Die alte, umständliche
Lösung mittles !stg_no_database und !raw [stg] @database ist
demnach nicht mehr nötig. Wird !docinfo [stg_database] nicht
verwendet, so erzeugt UDO wie gehabt eine Zeile, gebildet aus
!docinfo [title] und !docinfo [program].
. Änderung: Der Schalter !stg_no_database existiert nicht mehr.
. Bugfix: Wurde in PL2 kein !docinfo [program] benutzt, so wurde in
der Kopfzeile Murks ausgegeben.
WinHelp:
. Bugfix: Schriftarten wurden in Bidunterschriften nich
umgewandelt.
GEM-Version:
. Neu: Die Kommandozeilenoption "--force-long" kann nun auch in der
GEM-Version benutzt werden.
. Änderung: Der Hauptdialog wurde aufgeräumt und benutzt neben
zahllosen Radio-Buttons nun ein Popup.
. Änderung: Unter MagiC wird nun auch eine Menüzeile angemeldet.
. Änderung: Der Dialog "Externe Programme" wurde aufgeräumt.
Anstatt der zahllosen Radio-Buttons wird nun eine Listbox
verwendet.
Windows-Shell:
. Neu: DRC und IPF können nun ausgewählt werden. HelpTag steht
dafür nicht mehr zur Verfügung. Die neue Shell ist nur im
Windows-Beta-Archiv enthalten und nicht über meine reguläre
Homepage erhältlich.
1.11 PL2 vom 26.03.1997
========================
Dieser Patchlevel ist hochgradig beta, da ich habe fast überall
Änderungen und Laufzeit-Optimierungen vorgenommen habe.
Fehlfunktionen, Abstürze etc. bitte sofort melden!
Allgemeines:
. Syntaxänderung: Die Format-Spezialbefehle haben sich geändert.
neu | alt
------------+------
!raw [asc] | !asc
!raw [stg] | !stg
!raw [win] | !win
etc. | etc.
Innerhalb der Klammern können nun die gleichen Ausdrücke
verwendet werden wie bei den Abfragebefehlen, also auch mehrere
oder `all' und `none'.
Die Befehle, die nur Zeilen ausgeben, wenn man nicht in das
passende Format umwandelt, existieren nicht mehr und können über
obigen !raw-Befehl auch nicht direkt erzeugt werden. Hier muß man
nun den Umweg über eine Abfrage-Raw-Kombination gehen. Beispiel:
Früher:
!=asc Dies erscheint nur beim ASCII-Format nicht.
Jetzt:
!ifndest [asc]
!raw [all] Dies erscheint nur beim ASCII-Format nicht.
!endif
. Syntaxänderung: Die Befehle für die Titelseiten-Informationen
haben sich geändert. Ein paar neue sind außerdem hinzugekommen.
neu | alt
-------------------------------+--------------
!docinfo [title] ... | !title ...
!docinfo [program] ... | !program ...
!docinfo [version] ... | !version ...
!docinfo [date] ... | !date ...
!docinfo [author] ... | !author ...
!docinfo [address] ... | !street ...
!docinfo [address] ... | !town ...
!docinfo [address] ... | -
!docinfo [address] ... | !country ...
!docinfo [address] ... | !email ...
!docinfo [webmastername] ... | -
!docinfo [webmasteremail] ... | -
!docinfo [webmasterurl] ... | -
Wie man sieht, sind die speziellen Befehle wie !street, !email
etc. weggefallen. Sie werden nun unter !docinfo [address]
zusammengefaßt. Zudem sind nun insgesamt 15 Adreßzeilen möglich.
Was Ihr da angebt, das bleibt Euch überlassen.
Die Webmaster-Angaben sind nur für HTML von Belang. Näheres dazu
siehe unten.
. Syntaxänderung: Die Befehle zum Setzen des Zeichensatzes haben
sich geändert. Jetzt gibt es nur noch einen Befehl (!code).
Diesem Befehl übergibt man den benutzten Zeichensatz als
Parameter:
neu | alt
--------------------+-----------------
!code [dos] | !code_dos
!code [hp8] | !code_hp8
!code [iso] | !code_iso
!code [mac] | !code_mac
!code [next] | !code_next
!code [tos] | !code_tos
--------------------+-----------------
!code [latin1] | wie !code [iso]
!code [iso-8859-1] | wie !code [iso]
. Neu: DRC-Format (David's Readme Compiler für DOS),
Kommandozeilen-Option --drc, allerdings noch nicht komplett
implementiert.
. Neu: IPF-Format (Information Presentation Facility, OS/2),
Kommandozeilen-Option --ipf, allerdings noch nicht komplett
implementiert. Außerdem habe ich keine Möglichkeiten, UDOs
Ausgaben zu überprüfen, ich bin daher auf Eure Mithilfe besonders
angewiesen.
. Neu: Die C-Sourcecode-Umgebung läßt sich nun mittels
!ifdest [src] abfragen. Für Pascal benutzt man !ifdest [pas]
(Patrick Jerchel).
. Neu: Platzhalter (!nolink [ ]). Der Inhalt der Klammern wird
nicht referenziert.
. Neu: Befehl !jumpid. Dieser Befehl kann maximal einmal pro Node
benutzt werden. Ausgegeben wird die ID wie ein Alias. Jump-IDs
können als C- oder Pascal-Headerfile ausgegeben werden (bitte mal
die Pascal-Ausgabe überprüfen, ich bin da zu lange raus).
. Neu: comment-Umgebung (!begin_comment, !end_comment, !cinclude)
(Martin Rost). Text, der innerhalb der Umgebung steht, wird als
Kommentar auch in die Ausgabedatei geschrieben, sofern das
jeweilige Format Kommentare beherrscht.
. Neu: Schalter !no_footer [ ]. Wird dieser Schalter für HTML
gesetzt, so werden keine Webmaster-Angaben am Ende einer jeden
Seite ausgegeben, sofern letztere vorhanden sind.
. Neu: Kommandozeilen-Option -@ file. UDO liest dann aus der Datei
file die Optionen. In dieser Datei muß in jeder Zeile genau eine
Option stehen. Beispiel:
$ udo -@ 4stg.opt udo6ger.u
[4stg.opt]
--stg
-o
udo.stg
--verbose
Dies ist gerade für die DOS-Version praktisch, da bei
entsprechend langen Dateinamen der Platz nicht für alle Optionen
ausreicht. Die UDO-Shell wird demnächst entsprechend angepaßt.
. Neu: Kommandozeilen-Optionen --c-idfile und --pas-idfile. Werden
diese Optionen angegeben, so erzeugt UDO eine H-Datei für C
und/oder eine I-Datei für Pascal, in denen Konstanten mit allen
Jump-IDs ausgegeben werden. Vorsicht: UDO überschreibt
existierende Headerfiles ohne Rückfrage!
. Neu: Kommandozeilen-Option --force-long. Wird diese Option
benutzt, so versucht UDO auch auf den Systemen, die standardmäßig
keine langen Dateinamen unterstützen (TOS, DOS), lange Dateinamen
zu erzeugen (Endnung .html anstatt .htm).
. Neu: Den Befehlen, die sich um die Ausgabe der
Inhaltsverzeichnisse kümmern, kann man nun einen weiteren
Parameter übergeben, der angibt, wie tief die Ausgabe des
Inhaltsverzeichnisses gehen soll (Martin Osieka). Beispiele:
- !tableofcontents !depth 1
Im Inhaltsverzeichnis werden nur die Nodes (1. Ebene)
ausgegeben.
- !tableofcontents
Komplettes Inhaltsverzeichnis ausgeben.
- !toc [all] !depth 2
Bei allen Formaten wird das Inhaltsverzeichnis ausgegeben,
hier jedoch mit genau 2 Ebenen, also den Nodes und den
Subnodes.
- !subtoc [stg,win] !depth 1
Für ST-Guide und WinHelp werden im Unterinhaltsverzeichnis
eines Nodes werden alle Subnodes (auch hier die 1. Ebene
unterhalb der Nodes) ausgegeben.
- !use_auto_subtocs [stg,win] !depth 2
Unterinhaltsverzeichnisse werden für ST-Guide und WinHelp
automatisch erzeugt. In ihnen werden jeweils nur die
Subnodes und Subsubnodes (Tiefe gleich zwei) ausgegeben,
nicht die Subsubsubnodes (das wäre ausgehend von den Nodes
die dritte Ebene).
Aufgrund dieser sehr flexiblen Möglichkeit, die Tiefe der
Inhaltsverzeichnisse zu steuern, sind einige Schalter überflüssig
geworden (siehe unten).
. Änderung: Die Schalter
- !use_short_toc
- !no_toc_subnodes
- !no_toc_subsubnodes
- !no_toc_subsubsubnodes
existieren nicht mehr. Aufgrund der obigen Neuerungen wurden sie
überflüssig bzw. paßten nicht mehr ins Konzept.
!no_toc_subnodes kann nun durch !tableofcontents !depth 1 ersetzt
werden.
. Änderung: Die komplette Auswertung der Optionen wurde bei der
Kommandozeilen-Version überarbeitet. Nun muß der Name der
Quelldatei nicht als letzte Option angegeben werden, jedoch ist
auch nur noch die Angabe einer Quelldatei möglich. Zudem fehlten
bei udo --help einige Angaben.
. Änderung: UDO kann nun auch Dateien "includen", die Leerzeichen
im Namen enthalten. Ist dies der Fall, so muß man den Dateinamen
in Anführungsstriche setzen. Beispiel:
!include "hello world.u"
. Änderung: Wird !tabwidth 0 benutzt, so wandelt UDO keine TABs
mehr in verbatim-/sourcecode-Umgebungen in Leerzeichen um
(Patrick Jerchel).
. Änderung: UDO gibt jetzt eine Fehlermeldung aus, wenn !maketitle
benutzt wird, ohne irgendwelche Informationen für die Titelseite
bereitgestellt zu haben.
. Änderung: Umfangreiche Optimierungen. UDO sollte spürbar und
meßbar schneller fertig sein. Probiert es mal aus.
. Änderung: UDO benutzt jetzt zur Erzeugung der temporären Datei
für die eigene Werbeseite tmpnam() (Martin Osieka). Wundert Euch
also bitte nicht, falls im Logfile oder bei --verbose ein
komischer Dateiname auftauchen sollte.
. Änderung: Auf den Systemen, die den ISO-Latin1-Zeichensatz
verwenden, wurden zu oft unbekannte Zeichen bemängelt. Die
Warnmeldungen bezüglich der Zeichenumwandlung sind nun außerdem
informativer.
. Änderung: Es sind nun 4096 Nodes und Labels/Aliase benutzbar.
. Änderung: Die Titelseite wird intern nun dynamisch verwaltet,
daher sollten keine Probleme (bis auf den fehlenden Umbruch) mehr
bei überlangen Einträgen auftreten.
. Änderung: Die Einträge für das Inhaltsverzeichnis werden nun zur
Hälfte dynamisch verwaltet. UDO sollte daher auf Systemen mit
wenig RAM nicht so schnell die Puste ausgehen.
. Bugfix: Bei !toc wurder der Begriff "Anhang" nicht ausgegeben
(Berthold Reiff).
. Bugfix: Der Schalter !no_images wurde nicht bei )!ilink [ ] und
(!img [ ]) beachtet. Außerdem werden nun bei !no_images keine
Bilder mehr in den Kopf- und/oder Fußzeilen bei HTML ausgegeben.
. Bugfix: Beim Beenden der Sourcecode-Umgebung wurden !end_quote
und !end_verbatim in der falschen Reihenfolge aufgerufen (Hauke
Wessels).
. Bugfix: Umlaute in Zeilen, die mit einem `#' begannen (also UDO-
Kommentare), wurden in verbatim-Umgebungen nicht oder falsch
umgesetzt.
. Bugfix: Bei (!xlink ...) wurde !! nicht angepaßt (Christian
Goßlar).
. Bugfix: Jetzt sind - wie in der Doku beschrieben - fünf Zeilen
mit !email möglich (Bertholf Reiff).
. Bugfix: Eine leere !email-Zeile wurde bemängelt, es wurden aber
trotzdem Leerzeilen ausgegeben (Berthold Reiff). Tip: Leere
Zeilen erzeugt man nun, indem man nur eine Tilde (festes
Leerzeichen) angibt.
. Bugfix: Die Schriftarten-Befehle wurden auf der Titelseite nicht
abgepaßt (Berthold Reiff). Schriftarten können nicht auf der
Titelseite benutzt werden. Wer diese benötigt, muß sich selbst
eine Titelseite gestalten.
. Bugfix: Wurde in einer Zelle einer Tabelle mehr als 128 Zeichen
verwendet, so stürzte UDO ab (Frank Röske). Jetzt erfolgt eine
Fehlermeldung und die Zeile, in der die zu große Zelle benutzt
wurde, wird nicht ausgegeben.
. Bugfix: Bei folgender Konstellation geriet UDO in eine
Endlosschleife, da das erste Kommando aufgrund der fehlenden
Klammer nicht beendet wurde:
Bla fasel (!command [!..] [!..] (!B)foo(!b)
Bei command gleich xlink, plink, link, macro, idx und img trat
eine Endlosschleife auf.
. Bugfix: Schriftarten sollten nun bei !index funktionieren.
. Bugfix: Es wurde nur ein (!ilink) pro Zeile übersetzt (Stefan
Braunstein).
HTML:
. Neu: Werden mit !docinfo Webmaster-Daten angegeben, so erzeugt
UDO standardmäßig am Ende einer jeden Seite folgendes:
Copyright (c) by <webmastername> [<webmasteremail>|<webmasterurl>]
Letzte Änderung am (!today)
!webmasterurl hat Priorität vor !webmasteremail. Werden keine
Angaben gemacht oder im Vorspann !no_footers [html] benutzt, so
gibt UDO nichts aus.
. Neu: !html_modern_layout
Wird dieser Schalter im Vorspann ausgegeben, so wird jede Seite
als Tabelle dargestellt. Die Tabelle besteht dann aus zwei
Spalten, wobei in der linken Spalte die Links auf die anderen
Nodes und in der rechten Spalte der Seiteninhalt ausgegeben
werden. Benutzt man !chaptericon innerhalb eines Nodes, so werden
in der linken Spalte Imagelinks angelegt.
Hinweis: Dieses Feature ist noch niegelnagelneu, ich habe es erst
vor einer Stunde eingebaut. Es fehlt noch die Möglichkeit, die
Breite und Hintergrundfarbe der linken Spalte sowie den Abstand
von linker zu rechter Spalte zu beinflussen. Wie ich gerade sehe,
stellt der Internet-Explorer die Tabellen anders dar als der
Netscape Navigator es tut. Hier werde ich also noch etwas testen
müssen.
. Neu: !chaptericon
Dieses Kommando gibt den Namen einer Grafik an, welche UDO für
den Link auf den aktuellen Node in der linken Spalte des
"modernen" Layouts verwenden soll. Bei Subnodes und tieferen
Ebenen wird der Befehl momentan mißachtet.
. Neu: Schalter !html_ignore_8bit
Wird dieser Schalter im Vorspann angegeben, so werden 8-Bit-
Zeichen nicht in HTML-Entities (ä etc.) umgewandelt (Rein
Bakhuizen van den Brink). Somit ist es möglich, auch von ISO-
Latin1 abweichende Dateien zu erzeugen, ohne das UDO
dazwischenfunkt.
. Änderung: Bei den Bezeichern von Labels und Nodes werden alle
nicht-alphanuemrischen Zeichen nun durch %XX ersetzt, wobei XX
der Hexcode des jeweiligen Zeichens ist. Hiervon ausgenommen sind
neben `a'-`z', `A'-`Z' und `0'-`9' die Zeichen `$', `+', `-', `.'
und `_'.
. Änderung: Auf System, die lange Dateinamen unterstützen, benutzt
UDO nun für die Numerierung der HTML-Dateien drei Stellen pro
Ebene anstatt zwei (001002003004.html anstatt 01020304.html).
. Bugfix: Bei Bildern ohne Bildunterschrift wurden bei HTML für das
IMG-Tag keine Anführungszeichen ausgegeben (Stefan Braunstein).
. Bugfix: Slashes werden bei !html_backimage nicht mehr in
Backslashes umgewandelt (Heiko Schäfer).
. Bugfix: Auf der ersten Seite wurde keine Kopfzeile ausgegeben,
wenn man auf !maketitle verzichtete.
LaTeX:
. Neu: Komprimierte Umgebungen mittels !short sind nun auch bei
LaTeX erzeugt, indem UDO folgendes in der Umgebung ausgibt:
\itemsep 0pt
\parsep 0pt
\parskip 0pt
. Neu: Unterinhaltsverzeichnisse werden nun auch für LaTeX
ausgegeben (Hauke Wessels). Dazu wird eine Itemize-Umgebung
verwendet.
. Neu: Zu jedem Node wird nun ein gleichlautendes Label ausgegeben,
so daß man auch ohne Gefahr bei den Links auf Nodes verweisen
kann (Hauke Wessels).
. Änderung: Bei !no_toc_subnodes [tex] werden keine Nodes mehr
"versteckt". Ich muß jetzt nur noch den LaTeX-Befehl
herausfinden, mit dem man die Ausgabetiefe bei LaTeX ändern kann.
Pure-C-Help:
. Im Seitenheader benutzt UDO nun capsensitive anstatt sensitive.
UDO selbst beachtet ja auch die Groß-/Kleinschreibung.
. Auf das Inhaltsverzeichnis werden in den Kopf- und Fußzeilen
keine Links mehr angelegt, wenn man gar kein Inhalstverzeichnis
hat erzeugen lassen.
ST-Guide:
. Bugfix: Links auf Nodes, die ein @ (im Linktext oder Nodenamen)
benutzten, wurde das @ einmal zuviel ausgegeben (Holger Herzog).
. Bugfix: !alias und !ignore_links funktioniert nun auch bei !pnode
und den verwandten Befehlen.
. Änderung: Beim ST-Guide werden in Listen wieder zwei Leerzeichen
Abstand ausgegeben (Martin Osieka).
WinHelp:
. Änderung: UDO benutzt nun Nummern zur Referenzierung der Nodes
innerhalb der RTF-Datei. Dadurch ist es möglich, Nodes zu
benutzen, die sich nur durch Groß-/Kleinschrebung unterscheiden.
. Bugfix: In den Subtocs stimmte die Einrückung bei manchen
Einträgen nicht. Man sah nur noch die letzte Nummer (Peter-F
Bajetto).
1.12 PL1 vom 10.02.1997
========================
Allgemeines:
. Neu: Holländisch wird als Sprache angeboten (Danke an Rogier
Cobben). Aktiviert wird sie mit !language dutch, abgefragt mit
!iflang [dutch].
. Neu: Schalter !code_next zum Umschalten auf den NeXTStep-
Zeichensatz.
. Änderung: Die ganzen alten Sprachbefehle wie !german oder
!english existieren nicht mehr. Die Ausgabesprache läßt sich nun
nur noch mit !language einstellen.
. Umlaute in !table_caption* wurden nicht gequotet (Christian
Goslar).
. Die GEM-Shell benutzte "udo.hyp" als Hypertextname, obwohl der
Hypertext "udo6ger.hyp" heißt (Michael Depke).
HTML:
. Neu: Na endlich! Jetzt werden auch bei HTML die list-Umgebungen
korrekt ausgegeben. UDO erzeugt dafür nun HTML-Tabellen. Leider
unterscheiden sich Navigator und IE bei der Ausgabe der Tabellen,
besonders was die Zwischenräume und den Umbruch der ersten Spalte
angeht. Hier werde ich noch ein wenig experimentieren.
. Änderung: Der Schalter !html_use_xlist existiert nicht mehr. UDO
verwendet per default obige Methode
. Neu: Der Schalter !html_no_xlist führt dazu, daß UDO anstatt die
Listen wie bisher als description-Umgebungen ausgibt.
. Neue Befehle zum Einbinden von Body-Optionen für Nodes:
- !html_backimage <file.suffix>
Setzen eines Hintergrundbildes. Momentan muß man noch die
Dateieindung angeben; UDO setzt sie nicht automatisch
dahinter.
- !html_backcolor [<color>|#FFFFFF]>
Setzen der Hintergrundfarbe. Vordefinierte Farben sind
black, white, red, green, blue, yellow, cyan, magenta und
grey. Will man eine andere Farbe haben, so kann man den
Hexwert auch direkt angeben.
- !html_textcolor [<color>|#FFFFFF]> Setzen der Textfarbe.
- !html_linkcolor [<color>|#FFFFFF]> Setzen der Farbe für
Links.
- !html_alinkcolor [<color>|#FFFFFF]> Setzen der Farbe für
aktive Links.
- !html_vlinkcolor [<color>|#FFFFFF]> Setzen der Farbe für
bereits besuchte Links.
Anmerkungen:
- Werden die Befehle im Vorspann benutzt, so setzt man damit
die Defaultwerte für alle Seiten inkl. dem
Inhaltsverzeichnis.
- Bei Angabe der Farben übernimmt UDO genau dann den
angegebenen Wert, falls das erste Zeichen ein `#' ist.
. Neu: !verbatimsize wird nun für HTML unterstützt.
. Änderung: In den Kopfzeilen wird keine Titelzeile, sondern nur
noch die Verweise auf die benachbarten Seiten ausgegeben. Der
Titel wird mit ins <TITLE>-Tag gesetzt. So sieht es besser aus.
Außerdem weiß jemand, der eine Seite nicht über die Homepage
ansteuert, sofort wo er ist und in welchem Kontext die Seite
steht.
. Bugfix: Wurde nur !no_headlines oder nur !no_bottomlines
verwendet, so sicherte UDO die Button-GIFs nicht. Er tut dies
jetzt nur dann nicht mehr, wenn für HTML beide Schalter gesetzt
werden.
. Bugfix: Wurden Kapitel gemischt, so fehlten die Buttons, mit der
man zur nächsten Seite verzweigen konnte. Ich hoffe, jetzt
funktioniert es korrekt.
. Bugfix: Bei Tabellen wurde <p align=center nach <table>
ausgegeben (Hans Braun).
Pure-C-Help:
. In verbatim-Umgebungen wurden interne Escape-Sequenzen nicht
ersetzt. Dadurch schlug die Referenzierung fehl (Peter
Hellinger).
ST-Guide:
. `@width' wird nun immer ausgegeben (Martin Osieka).
. In `@{ ... ignore }' wurden auch die `@' angepaßt, was nicht sein
durfte (Martin Osieka).
. Wird (!nl) benutzt, so entfernt UDO Leerzeichen am Ende der
Zeile, damit Hyperion nicht durcheinander gerät (Manfred Osieka).
. Chapterimages wurden nicht zentriert ausgegeben.
WinHelp:
. Chapterimages wurden nicht zentriert ausgegeben.
1.13 PL0 vom 02.01.1997
========================
Allgemeines:
. Neu: Schalter !use_mirrored_indices [ ]. Wird dieser Schalter
benutzt, so legt UDO beim Befehl !index oder bei der
Platzhalterversion (!idx...) auch die "gespiegelten" Einträge an,
falls man einen Doppeleintrag vornimmt. Falls man also diesen
Schalter benutzt, dann kann man sich bei der Angabe von
!index A !! B
die folgende Zeile sparen:
!index B !! A
. Neu: flushleft-Umgebung (!begin_flushleft, !end_flushleft).
Hiermit kann man den Blocksatz partiell ausschalten.
. Änderung: Falls eine Datei nicht geöffent werden konnte, wird nur
noch eine Zeile im Logfile ausgegeben.
. Änderung: Die Fehlermeldungen bezüglich der Umgebungen wurden
etwas verfeinert. So werden nun auch fehlende !end_flushright und
!end_flushleft bemängelt.
. Änderung: !break ist nun ein Kommando wie alle anderen auch und
kann daher auch in Abfragen auftauchen. Es wird nun weder in
verbatim- und raw-Umgebungen noch in Tabellen beachtet.
. Neu: Mit dem Befehl !table_caption* kann man einen Tabellentitel
ohne die Angabe von "Tabelle #" erzeugen (Christian Goßlar).
. Neu: Mit dem Befehl !image* kann man ein Bild ausgeben, wobei die
Bildunterschrift ohne "Abbildung #" erzeugt wird (Christian
Goßlar).
. Bugfix: Spezialbefehle wie !stg, !html etc. beachteten nicht die
if-else-Zweige (Christian Goßlar).
. Änderung: Der Schalter für den Blocksatz heißt nun
!use_justification anstatt !use_justified.
. Änderung: Es sind nun 3000 Kapitel benutzbar.
LyX:
. Bug fix: LyX kennt keine "Chapter*", daher gibt UDO für
!use_style_book für !node* ebenfalls "Chapter" aus. Daher werden
bei LyX auch Kapitel numeriert, die bei den anderen Formaten
nicht numereriert werden.
. Bug fix: Schriftarten in Kapitelnamen funktionierten nicht.
ST-Guide:
. Neu: !autoref_items wird nun auch für description- und xlist-
Umgebungen unterstützt.